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Disclaimer 
This is a prelininary version of the SCRIBE manual. It is being 

circulated so that there Mill be so«e manual available/ however 
incomplete, and to get comments front users about its clarity and 
content* 

If you have conents about the accuracy of this manual, you way 
comment by sending mail to Reld8CMU-10A. If you have consents about 
its readability, clarity, content, or style, please send cements to 
the saie address* 

Soae of the information In this manual describes system features 
that are not fully inplevented as the manual goes to press. Let's 
just call these "lies". As far as I kno», this is an exhaustive list 
of lies in the aanual. 

- Use of §k to get special characters on the XGP does not work 

yet- It only »orks on the Diablo and the LPT. 

- SCRIPS does not yet produce the promised list of "faked" 
special characters to tell you where to Mrlte these 
characters in by hand* 

- the Letter Head and leaolead document types do not work on 

the XGP. they do nork on the Diablo. 

- The bibliography aechanlsa does not work as advertised. An 
lnteria bibliography nechanlsa is available.? contact ae for 
details. 

- The opart command is not fully debugged. 

I hope to get all of these features fully operational before the final 

draft of this first edition nanual is produce in September 1978. 

Brian K- Held 
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Preface 
This manual is a beginner's manual for the SCRIBE document 

production system developed in the Computer Science Department at 
Carnegie-Mellon University. 

The reader is expected to have used (however briefly) a timesharing 
computer, to know how to use a text editor* and to understand the 
notion of a timesharing "file system**. io particular computer 
expertise or knowledge of programming is needed- If fou feel that you 

don't have that background/ see the CMO Conputer Science Department's 
Computer Pr later. On the other hand, if you have a lot of programming 

experience . and would like to know more, there is a SCRIBE Expert's 
Manual available, as a companion to this one. 

SCRIBE is still under development. This first edition of the 
Introductory User's Manual was written for internal use In the 

Computer Science Department, and the exaaples are taken fro« the 
documents that coaputer scientists produce. 

This manual Mas produced with SCRIBE and printed on the Coaputer 
Science Department's Xerox graphics Printer. 



SCRIBE CTSER'S MftOTAL PJlG g 3 

14 Introduction 

SCMBS is a document production prograa. It produces documents 
(assigned to be read fay humans) fro» Manuscript files which are 
primarily to be read by the computer. The manuscript files that SCRIBE 
processes are created by human beings using a text editor,? the 
document files that SCRIBE produces are printed on printing devices to 
produce paper copy. 

SCRIBE is a big program. It has aany exotic capabilities* ffiost of 
which you will probably never need. But as the people who sell cars 
with big engines are fond of saying* it's nice to have the po^er there 
in case you need to use it. 

Unlike many big prograas, SCRIBE looks siaple. You don't need very 
©any cowsands, and the ones that you do need are not complicated. If 
you have used computer text editors before, you should be able to 
learn enough about SCRIBE in an hour to be able to produce your first 
document, As you learn wore about document production and find that 
you want lore "features" or «ore poser, just read farther in the 
aanual and you Hill probably find what you are looking for- 

The SCRIBE Expert's Manual* a companion volume to this one, 
describes how to do coaplicated things. Me have made it a separate 
manual to ecphasize the fact that SCRIBS is quite useful to people who 
aren't experts, and also to save printing costs* since not everybody' 
wants to be an expert. 

lit. Suae Explanation for lon-Progra»»ers 

the preparation of a document requires, in addition to the actual 
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text, an understanding of bow the text is to foe formatted. When a 

secretary types a document, he applies his knowledge of typing ana 
formats and his understanding of what the words and sentences aiean* 
and chooses a reasonable format for various pieces of the text* Vhen 
a typographer typesets a docuaeiit for publication* he needs editor's 
marfcs* tn colored pencil* to show him what to do. 

Computers are at a double disadvantage In the production of 
documents. They are not clever* like secretaries* nor can they read 

penciled proofreader's marks* like typographers. Computers can 
recognize the 95 characters on their keyboard* but not penciled notes. 
Soaehow* using only those 95 characters* we must devise a .means of 
communicating to the coaputer all of the various kinds of information 
that secretaries can figure out for th ease Ives and typographers get 
iroa the pencil narks. SCRIBE has such a scheme* using, special 
sequences of characters to represent foraatting coaaands, and if it 
sometimes seems to you as though a certain construct is too baroque or 
too mathematical r plaase understand uhy it is that way. 

1.2. Soae Explanation for Programmers 

SCRIBE is a one-pass program that is table-driven and configurable? 
the language that it processes is non-procedural- It can be run in an 
ideapotent processing mode or in regular "compilation* mode. 

From its input files (manuscript files J* SCRXBS can. produce tio 
outputs; an output file* suitable for printing on the appropriate 

printing device* and an updated version of the input manuscript f He- 
ine ideapotence property prescribes that if SCfilBE is used to update 
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trie same manuscript file twice in a row, then the second update will 
not actually change the file. The line and page breaks in the updated 
manuscript tile will correspond to the line and page breaks in the 
finished output file. 

SCitlBE does not have 'comiands- in the usual sense of the word: its 
commands are not procedural. I SCRIBE coaaand . specifies the result 
that is desired rather than the aetfeo-i to achieve it- For example, to 
enter a quotation in running text, it is custosary to switch to single 
spacing, indent the left and right margins., and then change back again 
to noruai aargins and spacing. In SCRIBE, this would fee achieved by 
Placing a "fbeginCquotation)* coassaRd at the front of the guotation-s 
text, and a M §End{guotation) n after its text. The details of the 
knowledge of ho« to print a QUQTATIQM are encoded in SCRIBE'S internal 
tables. 

SCftiBS is configurable, in the sense that users may change, replace, 
or augment the foraatting knowledge contained in its tables. While 
radical changes to SCRIBE'S behavior cannot be achieved by changing 
the tables, nearly any conventional text effect can be achieved. Most 
users with uncomplicated needs will never want to use the 
configuration nechanisns. Honev«r, for those with complicated needs or 
the urge to tinker, there is a co«p anion aanual, the Scribe Expert's 
Manual, that explains all tl»e many details of modifying and 
configuring the system. 
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2$ k Beginner's Guide 

This chapter is for «e« users, «ho have never used SCRIBE before and 
»ho »©uld like to learn how to use it for simple things- 
ail. Preparing Input for Scribe 

A Manuscript file prepared for input to SC8IB1 consists primarily of 
Plain text. Paragraphs are separated by blank lines, and consaands, if 
present, are flagged with an *»§*» sign. If you want an **§" sign to 
appear in your output, you sust type two of thews n %% n + The various 
comtands are described in this and following chapters. A file 
containing no coaaands at all sill «ork 3ust fine? It will yield 
staple Justified paragraphed text. On the PDP-10, a manuscript file 
should be given the extension ".MSS"? our example that Me discuss here 
Mill be called TRIAL. «SS. 

2*2. Running Scribe 

Suppose that we have built a Manuscript file named TSIM..MSS, with 

1 
the following contents! 

00100 So when he case to the churchyard Sir Arthur alighted and 

tied his 
00200 horse to the stile- And so he went to the tent and found 

no knights 
00300 there for they Here at jousting. And so he handled the 

ssrord by the 
00400 handles and lightly and fiercely pulled it out of the 

stone, and took 
00500 his horse and rode Ms «ay until he case to his brother, 

Sir Kay, and 
00600 delivered his the sword. 
00700 
OOiOO And as soon as Sir Say saw the svord he Hist well it Has 

the sword 
00900 fro a the stone, and so he rode to his father. Sir Ector, 

1 

Proa Le iorte Darthur, by Sir Thomas Malory. 
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and said, 
01000 "Sir, lo! here is the sword of the stone, wherefore I must 

be Ring of 
Oil 00 this land.* 

To process this file, we run SCRIBE; it. will prompt us for input by 
typing an asterisk? 

K SCRI8E 

In response to the prompt, type the file naae of the manuscript file 

that is to be processed. 

K SC8I8E 
•TKIAL* MSS 

SCRIBE will then process the file. It will produce as output a file 

called TE1AL.LPT. This TRIAL. LPT file that it produces, when typed on 

the terminal, will look something like this: 

So when he caae to the churchyard Sir Arthur alighted and tied his 
horse to the stile. And so he went to the tent and found no knights 
there for they were at jousting, and so he handled the sword by the 
handles and lightly and fiercely pulled it out of the stone, and 
took his horse and rode his way until he caae to his brother, Sir 
Ray, and delivered his the sword. 

And as soon as Sir Kay saw the sword he wist well it «as the sword 
troa the stone, and so he rode to his father, Sir Ector, and said, 
"Sir, io! here is the sword of the stone, wherefore I mist be King 

of this land. * 

1 

The reader is invited to copy the file TRIAL. M5S€4,562! and go 

tnrough this exercise. 

2.3. Printing Devices 

Mhen SCRIBE processes a Manuscript file Into a document file, it 
does so.Hitti a particular printing device in mind. The device 
characteristics determine the nufflber of characters that SCRIBE tries 

1 
Only at SRI. 
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to put on a line, the lumber of lines that it tries to put on a page, 
tfte methods used to accomplish underlining ana backspacing, and so on. 

It you don't tell SCRIBE anything one May or another about printing 

devices, it Mill assuiie that you are preparing a file for the line 

printer. If you aren't, you must put a fDfiflCE coasand at the 

Beginning of your Manuscript file, telling SCRIBE what device you are 

1 
using. The for»at is "§DEVI€E(Mhat kind)" ; so»e examples follows 

gi*£¥ICE<iPT} (the default ievice) Prepare for a line printer 

§0evice(IGP) Prepare docuaent for Xerox Graphics Printer 

§DEVICE(fiIABLO) Prepare for Diablo printer 

tdevlcetFILE) Prepare as a conputer file 

to return to our example of the previous section, let's change it to 

produce output for the X6P. The updated manuscript file TRIAL. MSS 

Mould no* look like this: 
000S0 idevice(ICP) 
00100 So when he canre to the churchyard Sir Arthur alighted and 

tied his 
00200 horse to the stile. .And so he went to the tent and found 

no knights 
00300 there for they Mere at lousting. And so he handled the 

s»ord by the 
00400 handles and lightly and fiercely pulled it out of the 

stone, and took 
00500 his horse and rode his way until he caie to his brother, 

Sir Key, and 
00600 delivered hia the s«ord. 
00700 
00800 And as soon as Sir Kay sasi the s«ord he Mist «ell it was 

the sword 
00900 frost the stone, and so he rode to his father. Sir Ector, 

and said, 
O160Q *Sir, lo! here is the s«ord of the stone, wherefore I must 

1 
Upper and lover case say be used interchangeably in any SCRIBE 
coasand; varying case sill be used throughout this manual to emphasize 
that. 
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be King of 
01100 this land,* 

If this file were now run through SCRIBE, it would produce an output 

tile naeed TRIAL, ISO suitable for printing on the XSP, instead off the 

TMIALiLPT that It produced before. 



The complete set of 

Page 
Code Length 



IEVTCS codes known to SCfiISC is shown below. 
Page 
Width Description 



LPT 


53 


lines 


XGP 


11 


inches 


DIABLO 


11 


inches 


SOS 


50 


lines 


FILE 


50 


lines 


CRT 


24 


lines 


LA3© 


66 


lines 



DECwriter 66 lines 
T1700 50 lines 



132 cols 
8.5 inches 
8.5 inches 
69 cols 
79 cols 

79 cols 
132 cols 

80 cols 
80 cols 



Line printer (standard) 
Xerox Graphics Printer 
Diablo By Type printer 
SOS file 

Standard DOC file 
Pages natch CRT screen size 
LA36 DECwriter full width 
LA38 DECwriter narrow width 
Texas Instruments 700 



lie expect to be able to add a device type for a photoconposing machine 
as soon as one becoses available to us. 

2.4. Characters and Keyboards 

SCRIBE'S noraal mode of operation is to take the characters that you 
type into the aanuscript file and see to it that they appear in the 
finished locuaent. If SCRIBE did this faithfully for all characters, 
then it Mould have no way of recognizing commands, for the "g" sign 
would he Just another character and not a special flag saying "a 
command follows". The special-character commands cause SCORE to 
insert a special character into the text in place of the command; 
another eoawand will leave space for you to write in the character by 
hand. 



2*4.1. Setting SCRIBE to Print Special Characters 

Remember that a computer keyboard normally has only 95 characters on 
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i 

it. People frequently «ant to include special characters, whether a 
Greek letter like 9 or z, or a roatheaatical symbol like ?< or ?7. 
These special characters are not available on the keyboard as 
individual keys. SCRIBE lets you specify special characters via 
auitipie-character "escape sequences 1 *. They are called "escape 
sequences** <a piece of computer Jargon) because you escape froii the 
noraal aeaning of the character. For example, If your manuscript file 
contains 

it A Sk(leq) b then §g{L) wist he 
then your finished output sill contain 

if A ?< 8 then L must be 
The §g{L) to print a laubda is a "font-change** code, -which changes to 
the Greek font. These are described in section FOMTCQDES- The 
iktleg) is a special-character escape sequence to generate the 
less-or-equal character. Appendix SPECIALCfURS has a table of special 
characters and »hat you aust type to get the*. 

2J4.2. Faking Special Characters. 

If the printing device that you are using cannot print the character 
you have asked for, SCfiXBE will leave a blank spot there s© that you 
can put the character in by hand, if you don't want to learn how to 
produce special characters, you can do the sane things Just leave a 
blank spot in your manuscript and then write the character in with a 
pen. Anywhere you put the sequence **§#**, SCRIBE will leave a blank 
space targe enough to write one character. Thus, if your Manuscript 
file contains 

Kaiser Mlhelastragfe 
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then SCHIBE Mill replace that "§#" by a aide space, printing: 

Kaiser Jfilhelastra e 
whereupon you iiould take pen in hand ana srite in the ■?#" character: 
Kaiser Milhelnstra?#e 

It you Mill need to &*rite special characters in by Band, SCRIBE Mill 
produce a list that sho«s you Mhere this aust be done? you need just 

sit down with the list and a black pen and <yrrite the characters- in. 
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31 Preparing a Manuscript 

You now know how to build a manuscript file that contains plain 
text, and then run it through SCRIBE to produce a document. In this 
section we will tell you how to fancy it up with italics* underlining, 
subscripts, superscripts, and so forth. 

Let's start with an example, then get to a nore general explanation. 

1 
To get italics, surround the letters that you want italicized with 

81C...3, like thiss 

The inscription read, "liCDe ainiaus non curat lexl." 

which will produce output that looks like this.: 

The inscription read, "De minimus non curat lex." 

Before going on with more explanations* we need to talk soae nuts and 
bolts. 

3*1. Deli niters 

Tne square brackets CI used in the exaaple above are called 
delimiters, they delis.it the characters being italicized. Computer 
keyboards contain several pairs of Hatching left and right delimiters, 
and any of thea aay equally well be used, for exaaple, you could have 
put #i<Oe ainimi*..) or |i<De iaini»us..>. It doesn't really natter 
which kind of deli alter you use as long as the closing delimiter 
watches tne opening delimiter. If you tried fi<De Minimus...}, SCRIBE 
will just keep italicizing until it co»es to a *>** character or the 

1 

If this document was printed on a device not capable of italicizing 
letters, then you will see underlining or overs tr iking where we intend 
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end of the paragraph- The delimiter pairs that you «ay use are {..->, 
C...3, €...}, <...>, *...*, *•..*, and »...". 

Suppose that you wanted boldface and underlining of the sane text, 
to get boldface* you use @bC--.1 around the text to be boldfaced. to 
get underlining, we put §uc...3 around the test to be underlined- 
»hy would anybody want fbcgltboldfaced underlining!!? 

this Is called nesting of the delimiters* the concept of nesting 
should be fas.il.lar to everyone In the notion off quotations inside 
quotations; the inner quotation is delimited with single quotes and 
tne outer quotation is delimited with double quotes, like this: 

Maconber said, "But the sign said *Mo Hunting.*" 
SCMBE is clever enough to let you nest like delimiters without 
getting itself confused, but you can use different delimiters if you 
s#ant 5 

«hy «ould anybody want @b<#iCb©Idff aced underiining1>? 
If you Kant to include an un-nested delimiter character inside a pair 
of delimiters, you have to be careful- Suppose, for exaaple, that you 
wanted to put an underlined ")« character in your text. If you used 
parentheses as delimiters, and put §uO), 'SCRIBf would treat that as 
"PO* followed by ")*», and would not do what you wanted* This wight 
seen like a useless warning, but the situation cones up in 
atatnefflaticai formatting. Equations and formulas are frequently 
printed with italicized variable naaes, and frequently ' contain 
parentheses, to get the sequence *»2*(4*y)-b" correctly Italicized, «e 
must be careful not to use parentheses as delimiters: iiC2*<4+y)-b3 
mil work, but §i<2*<4+y)~b) will not work. 
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3*2. Printing Device Considerations 

Sot every feature provided by SCRIBE can be realized on every output 
device- the line printer, for example, cannot print italics or even 
underline, but it can generate boldface by over striking, the XGP at 
CWU can italicize and underline and boldface, but cannot do italics 
and ooidfaca on the saa»e line. In fact, our X€P is restricted to no 
aore than two fonts in any pair of lines- Some of the features in 
SCRIBE cannot be achieved on any of the printing devices currently 
available to it, but Mere installed in anticipation of a 
pnotocoaposing machine or better Xerographic printers. For example, 
the overbar code #oO and the script code »sO cannot be printed on 
even tn« x«P eithout special tinkering that Is beyond the scope of 
this manual. 

3*3. Italics, Underlining, Etcetera 

SCRIBE recognizes all of the following font-change codes- Whether 
it will actually produce the requested font change depends on the 
nature of the final printing device being used. If SCRIBE cannot 
produce a particular code on a particular printing device, it will 
atteapt a compromise. In general, if a final printing device cannot 
print a particular effect, SCRIBE Mill generate underlining or 
overstrtking instead. 

SCRIBE recognizes this set of font-change codes, 
gitphrasej Italics 

gufphraseJ Underline non-blank characters 
@uxtphrase3 Underline all characters 
SumCphrasel Underline alphanunterics 



SCKIBg USSR'S MAS30AL PAGE 15 

SbC phrase J Boldface 

irtphrasel fio«an (the noraal typeface) 

gtCphrasel Typewriter font 

super 
9«-Cphrase3 script 

§cCphrase3 SMALL CAPITALS 
e^Cphrasej script 

§gCphrase3 Greek {Ellen) 

@otphrase3 Overbar 

3.4. Inserts 

You now know how to produce paragraphed text with various fancy 
effects like italics and underlining. In this section, we will shot* 
you how to insert various things into the middle of running text. 
Anything put into running text is called an Insert. Inserts can be 
quotations, examples, equations/ tables, blank space, or even 
Pictures. The text will resume in the saae paragraph after the insert. 

344.1. Specifying an Insert 

there are two ways of specifying an insert. The long forn requires 

more typing, but is inmune to problems with delimiters. Both yield 

the sa»e result. Consider this example; to put a quotation into 

running text, Me nark its beginning with "fBECIKQUOTAflOM)" and its 

end with *»§EndCQ»OTATIO!I)". Thus: 

fBegin(Quotation) 
Body of quotation- 
§End<Quotation) 

This Is the long torn. The short for» of the sa»e thing would be: 

§Ouotation< 

Body of quotation. 

) 
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ooviouslj, the short torn requires that the body of the quotation not 
contain a right delimiter. If your quotation is short, you can 
specify it all on one lines 

9Quotatlon(Body of quotation) 
SCRIBE will produce the sane output from any of these three forms. 

A quotation in running text cones out single spaced, filth -.the left 
and right margins pulled In a little, like this? 

The fact is, that civilization requires slaves. The Greeks 

were quite right, there- Tfnless there are slaves to do ugly, 
horrible, uninteresting work, culture and contemplation become 
impossible. Hunan slavery is strong, insecure, and 
demoralizing. On mechanical slavery, on the slavery of the 

1 
machine, the future of the «orld depends . 

3* ! 4*2. Simple Inserts 

SCRIBE knows about the following collection of simple insert types. 

Any one of them may be used in any document type. They »ay be used in 

the long forts (using BFSII and END), or the short for*, §IA«E{body of 

insert). ElTEt is a synonym for BEGIS and LEAVE is a synonym for EMO. 

Each of these insert types is described beloa? examples of the use of 

each can be seen in Appendix EXAMPLES. 

QOQTATIOi Text quotation 

VEfiSE 'Verse quotation 

EXAMPLE Example of computer type-in 

DISPLAY ion-Justified insert. Each line is separate. 

CENTER Each line centered 

VfiftBATIM Characters copied exactly, without formatting 

1 
From Oscar Wilde, The Soul of Man under Socialism, 1895 
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FORMAT Hand- foruat ted text 

ITBNIZE Paragraphs with a tick-nark in front of each 

EMOWKRATE Paragraphs with a number in front of each 

JJESCHIPtloS Outdented paragraphs; single spacing 

SQOATIOS Equation, with a mtftber put in the right margin 

TttEO«E« Munbered theorem 

3.4.2.1. QOOTATIGH and VESSS 

The QUOTATION insert has already been described <previous section). 
It inserts prose quotations in running text. 

The ygKSE insert differs froa the WGTATIOI insert in the Hay it 
handles line overflow. If a line in VERSE node doesn't fit, it will 

he spilt and the second part of the .line will be indented a bit froa 

the left, ft YERSE insert coies out looking like this: 

Oh # East is East and test is lest* and never the twain shall 

meet. 
Till Earth and Sky stand presently at God's great Judgment 

But there is neither East nor lest, border, nor breed, nor 

birth 
Shen two strong men stand face to face, though they coae froa 

1 
the ends of the earth . 

3.4.2.2. EXAMPLE and DISPLAY 

the EXAMPLE and DISPLAY insert types are very sisilar; they differ 
only in the type face that will be used. In either EXAMPLE or DISPLAY 
inserts, each line of the manuscript file will produce one line in the 
document, since EXAMPLE is for showing examples of cosputer type-in 

1 

Rudyard Kipling, The Ballad of East and lest. 
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and type-out (useful in user's manuals},. It will appear in a typeface 
that is designed to look like coispuler output- DISPLAY inserts will 
appear in the normal body type face. Thus: 

This is an EXAMPLE Insert 

This is a DISPLAY insert 

The exastpies were generated like this: 

SBegin(Exaiipla) 

This is an EXAMPLE insert 

tend (Example ) 

fBegin(Dlsplay) 

Til is is a DISPLAY insert 

§«nd(Display) 

If your copy of this manual was printed on a device that cannot change 

fonts (such as the Diablo printer ), then those two lines will look 

nearly identical. 

3*4.2-3. CEITBR 

A CENTfifi insert is similar to a DISPLAY, except that it centers its 
lines rather than left-justifying then. Like DISPLAY, CENTER produces 

one line in the document for each line of the -vanuscript file that is 
inside the CENTER* 

This is a CEWTER insert 
It there is wore than one line in a CEiTEP Insert, each line will be 
centered individually: for the exanple we just gave, the text to 
generate it was 

HBegin(center) 

This is a CENTER insert 

§ERd(center> 

although we could just as well have used 

ecenterCThis is a CENTBK insert) 

If you think that you want boldface centering, and find yourself 
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wondering whether you should say gt>(9c«itter(Hynah Birds)) or 
§center<#b(Mynah Birds)), the chances are that what you are really 
doing is naming a heading, and you should use iBeadiagCMynah Birds) 

instead? see Chapter HEMIiGCilP* 

3*4.2.4. VERBATIM and FORMAT 

A VERBATIM insert is printed exactly as you type it; no justifying 
or moving of the text will be done. SCRIBE Mill s«itch to a 
fixed-width font for the VERBATIM text, in order that coluans will 
line up properly. The 9 codes for underlining, italicizing, and the 
like »ill all be processed inside VE.R8ATIS. 

FORMAT aode differs frois VERBATIM only in that it uses a 
variable-sildth character set if one is available on the final printing 
device- In format aode, you would use the tabbing and formatting 
conuuands (described in Chapter TA8ST0PCHAPTER), rather than the space 
bar on your terminal, to align columns and achieve the desired 
effects. 

3.4-2.5, ITEMIZE and EOTIISRATE 

ITEMIZE and EHTOE1ATE each expect a sequence of paragraphs 
{separated by blank lines, as usual)? and each Justifies those 
paragraphs into inset margins and puts a nark in front of. each. 
ITEMIZE puts a tick-war k < M - **) in front of each paragraph, Mhile 
EH0MERATE puts a number In front of each- If you are not going to 
refer back to the numbers that EMWERATE generates, you should use 
ITEMIZE instead. An ITEMIZE coaes out looking like this: 
- First itea 
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- Second Item 

- Third and last 

kn enumerate looks like this: 

1- First item 

2» Second ite» 

3. Third and last 

The input text that »ade those examples Mas identical save for a 

substitution of names the itemization was: 

&BeginC itemize) 
First iteai 

Second item 

Third and last 
§£nd(ite»ize) 

while the enuaeration was 

iBegin{enuaierate) 

First item 

Second itea 

Third and last 
gEndCenuaerate) 

3*4.2.6. DESCRIPTION 

A JJESCaiPTIOM insert is designed for the "coasandl description" style 
that is so confflon in reference ssanuals. The first line of a 
DESCRIPTION insert will be at the left margin, and the second and 
re»aining lines will be indented substantially* so that the word or 
phrase at the head of the description stands out* If three or more 
blanks in a row are found on the first line of a DESCRIPTION they 
■ill be taken as a signal to tab to the left «argin provided that the 
left margin has not been passed,. Thus, this input: 



SCRIBE USER'S MAMAL PAGE 21 



§Begin(description ) 

Segment one of the parts into Mhich something naturally 

separates or is divided; a division, portion, 

or section. 
Section a part that is cut off or separated? a distinct 

part or subdivision of anything* as an object* 

country* or class. 
fBnd (description) 

Hill produce this output: 

Segwent One of the parts into which something naturally 

separates or is divided? a division* portion* or 
section. 

Section A Part that is cut off or separated! a distinct part 

or subdivision of anything* as an object* country* or 

class. 

3*4. 2. 7. EQBATIOM 

An EQOATIOM insert is almost identical to a DISPLA? insert: each 
line in the manuscript file generates one line in the docuaent* the 
left and right margins will be inset a bit* and it is printed in the 
standard body font- The difference is that the EG0ATIOI insert Hill 

cause an autoaatically generated equation number to be printed in the 
right aargin of each line in Hhich a §TAG coaaand (see section XftEFS* 
page XSEFS) appears. The §TA€ command is used to mark cross-reference 
points, and only those equations that Hill be cross-referenced need be 
nu»hered. 

This input text: 

fne gin (equation! 

SiCxl«-Cnni - §itx3#-i:n3-§iCF3(#iC.xli-rnl}/giCF3'(firx3i-Cn3> 
§r(or) 

#tagCMe«ton)fiE3c3@~m*li = (gii:x3§-tnU-@ii:c1/§irx3g-Di3) 

gEndCequation) 

sight produce output that looks like this (notice the equation nuatber 
over at the right): 
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x = x -f{x )/F*(x ) 

n+1 n n n 
or 
x = <x +c/x ) (3-12) 

n+1 n n 
3*4.2.8. THEOREM 

A THEOREM insert is almost identical to a QUOTATION insert: it Mill 
produce a single-spaced justified block of text* with the left and 
right margins pulled in a bit* The difference is that each time you 
do a etheoreuC) ©r a fBeginCTheorea), SCRIBE will add the prefix text 
••Theorea" and then print the current theorem number. Thus* this input 
text: 

§Theorew(?he closed interval Cartel is compact) 

* * ■■» 

gfoegin (theorem) 

A closed bounded subset of R#+Cnl is compact. 

88od{The©rem) 

Might produce this output text: 

Theorem 1-4: The closed interval fa*bl is compact. 

* * m 

n 

Theorem 1-5: A closed bounded subset of R is coapact. 

See section XREFS for a discussion of ho« to cross-reference theorem 

numbers using the §Ta§ and fft«f commands. 

3«5- footnotes 

1 
To get a footnote into running text* simply insert the sequence 

f*toot<body of footnote) 

into your text at the point where the superscripted footnote marker 

1 
tike this one 
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should appear, the footnote in the previous sentence was generated by 

To get a footnota§foot(Like this one) into 
running text* simply 

notice that SCRIBE automatically generates footnote numbers and puts 

thea in the proper places; don't put the numbers in yourself. 

In providing such a simple footnote aecnanisa, me feel a 
responsibility to advise you to use it sparingly- Footnotes seriously 

interfere with the readability of a paragraph, an<l their excessive use 

will' distract the reader rather than help hiw- 

3.6. Indexing 

An index could be built using the cross-reference nechanisat, as it 
is a fora of cross reference. However,, SCRIBE has a built-in indexing 
mechanise that is simpler and that will do the alphabetization for 
you. It's really quite simple. It any point in the text, you way put 
an entry of the form 

§lndex<Text to be indexed) 
Nothing sill appear in the running text output at that point, but 
"Text to be indexed" will appear in the index with the correct page 
nusaber: 

Text to he indexed 23 
Sou may put SCfilfiE connands into the index text if you want, but if 
you include any that cause a paragraph break you will get an 
unsatisfactory result. If you vant . an § sign to appear in the index 
entry, you have to use two; 

81nd«xC96index covnand) 
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4* Document types and Styles 

Reweaberlng our view that SCRIBE aspires to be a substitute for a 
secretary, consider the case in which a secretary is handed a rough 
draft of something and told to "sake a letter" or "itake a aeao«" Part 
ot ftis job is to know about basic document types and to be able to 
produce then as needed- SCRIBE also kno»s about basic document types, 
and will produce the kind of document that you tell it to. 

Each tine SCRIBE is run, it produces a docuaent of a particular 
"Oocunent type" for a particular printing device. A Docuaent Type 

Includes a specification of page format, paragraphing style, margins, 
heading and subheading style, and so forth- So«e document types are 
very specialized, such as the one naiaed "IEEE", which produces 
docuaents in the style and layout demanded by the various IEEE 
journals. Other document types are very general, such as the one named 
"TEXT", which produces paragraphed, .justified text on numbered pages. 

Hovice SCRIBE users should use the TEXT document type first <it*s 
the document type that you get if you don't ask for any particular 

one). Is they gain sore experience with the system or as they find the 
need to produce wore complicated documents, they should try other 
document types. 

4*1. SCHIBE's Database of Docuaent Types 

Docuaent types are defined by entries in SCRIBE'S database. ihen 
you request SCRIBE to produce a particular docuaent type, it searches 
its database for the definition and then reads in the definition, 
thereby setting itself up to produce the requested docuaent. If SC8IBE 
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cannot find in its database a document type with the name that you ask 
tor, it Kill tell you and then just halt? it can't really go on. 

412- Specifying a Document Type: the §Hake command 

The iMafce couand specifies document type. 8 Make (LETTER), for 
example, specifies the "LETTER* document type? gMakefTEXT) specifies 
the TEXT document type. The §Make command must coma at the beginning 
ot a manuscript file or it will not be honored. 8y "beginning" we mean 
before any text. The order of piake, gBevice, #Style, §Font, and other 
setup commands is not important. 

SCRIBE knows about the following types of documents, which is to say 

that this is the list of names you can put inside a liake command: 

LETTERHEAD A business letter with COT letterhead. 

LETTER A personal letter? you provide the return address 

REPORT a docuaent divided into nuabered chapters, sections, 

subsections, and the like? an automatic table of 

contents and outline will be generated. . 



MAHOAL Like REPORT, but with an index. 

REPORT1 Like REPORT, but the sections will not be nuabered. 

ARTICLE A sectioned document without chapters; SECTIOI is the 

highest-level of sectioning. 

ARTICLE! Like ARTICLE, but the sections will not be numbered. 

ROSTER k single-page poster or announcement 

S*»I»l An overhead-projector slide. Font and 'line spacing 

have been chosen to maximize readability. 

Since SCRIBE is still under development, we expect that the set of 

available document types will be expanded in due time. The SNAKE 

command must be at the beginning of your manuscript file. 



SCRIBE USER'S MAMfJAL PAGE 26 

In the Expert's Manual that is a companions to the one you are now 
reacting, you can find out how to define your o«n document types or 

modify the appearance of existing ones. Me recoaiiend that you not 
attempt this until you are an experienced SCRIBE user* In the 

meantime, you way use the §Style ana §F©«t commands that are described 
in chapter STYLiCHAPTEi to get snail changes In format and style and 
type face- 
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5J Titles, Headings, Sections, and the Table of Contents 

Almost every document has a title- Some have a title page. Others 
have headings and subheadings here and there in the text* In this 
chapter, you will find out ho« to do various kinds of titles and 
headings. 

As usual* ne'll start with some vocabulary. 1 document has one and 
only one title. This title goes on the title page, at the top of the 

first page, or sowething like that. A document can have nany headings. 
Sometimes you sight want to put a few subheadings inside a heading. 
It you give numbers to headings and subheadings, then they becoae 
sections. At the top {and/or bottom) of every page are the page 
headings, soastises known in the printing business as "running heads". 

Different document types use different schemes to produce headings 

or sections. This manual, for exanple, Has produced using the 
document type "MANUAL 1 *; it is divided into numbered chapters, 

sections* and subsections and has a table of contents, ft smaller 
document might have sections but not chapters? a short piece of text 
night have just a heading or two. The particular SCRIBE coaaands that 
you should use to get headings in your document depend on what kind of 
a docuaent you are producing. 

5*1. Headings in a Document 1'ithout a Table of Contents 

There is a simple set of heading co«»ands to produce headings for 
documents without tables of contents. They are simple because all 
they have to do is print the heading! they don't have to give it a 
number or put it in the table of contents. Use 
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- MaJorHeading to get large letters* centered. 

- Heading to get sediua-size letters* centered. 

- Subheading to get normal-size boldface letters, flush to the 
left margin* 

Thus* this input sequence? 

8Ma)orBeadingCThis is a Major Heading) 
§Heading(This is a Heading) 
«subfieading(This is a Subheading) 

will produce this output! 

THIS IS A MAJOV eEABIMG 

THIS IS A HEADING 

This is a Subheading 

That's ail there is to it. Since these heading commands are really 
just environaent names* you can use the "long form" call on then also: 

§feegin< Major Heading) 
This is a Major Heading 
HEnd<Ma3orHeading) 
Sbegin(Heading) 
This is a Heading 
§Endi«eadln§) 
ibeginCSubHeaaing) 
This is a Subheading 
§8»d{ Sub-leading) 

Htii produce the sane results as did the previous exaaple. 

5*2* .Headings in a Document Having a Table of Contents 

1 docueent having a table of contents must use a different set of 
coaaands for headings, they are different because they need both to 
print the headings in the text and to sake an entry in the table of 
contents. Usually these commands Mill automatically auaber the 
chapters and sections* though in some docuaent types they will not. 

The use of these sectioning commands is as si»ple as can bes 
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8Chapter< Chap tar Title) 
declares (and prints) a chapter title; 

@Sectlon($eetion Title) 
declares (and prints) a section title. 

In document types REPORT and iAOTAL, you get the following 
sectioning coiwands? 

Chapter, Section* Subsection, and Paragraph 

Appendix and Ipoendixsection 

OnMuubered 

prefacesection 

In document type ARTICLE, you get the sane list except "Chapter"? 
tile Highest-order sectioning comand in an ARTICLE is "Section". 

The easiest way to show you what these coaaands do is to draw your 

attention to the table of contents at the front of this »anua'l, and to 

reproduce here the first few sectioning coaaands that were used in it: 

§PrefaceSection<Pre.face) 

§Chap t er (Intro due tion> 

§section(So»e Explanation for ion-Programmers) 

8section( Souse Explanation for Prograflwers) 

8chapter(A Beginner's Snide) 

8s«ction( Preparing Input for Scribe) 

ftsectionCRunning Scribe) 

#Section(Printing Devices) 

#Section(charactars and Keyboards) 

gSubsectionCSetting SCRIBE to Print Special Characters) 

*Subsectloa<Faklng Special Characters) 

#Cftap( Preparing a Manuscript) 

Hotice that Chapter, Appendix, OnMuabered, and Prefacesection all 
cause SCftlBE to start at the top of a nen page. 

5**3. Numbering Pages and Page Seadings 

Tfte Information printed at the top or bottos of each page is called 



Left heading center heading Right heading 

a page heading (or page footing), Moraally SCRIBE Hill number the 
pages for you* putting a page number centered at the top of all pages 
after the first. ¥ou way, if you like, change the page headings to any 

text that you want. 

The page heading and footing areas are divided into three parts; a 
left part, a center part, and a right part, these parts are printed 

The headings and footings of this page are labeled to show you she 
position of these six fields. 

Page headings and footings are declared with the gPageheading and 
§PageFootIng commands* The cowaands for this page saids 

fPageheadlngUeft "Left heading", center "center heading", 

right "Right heading") 
fPagafootingOeft "Left footing",centert "center footing", 

right "Right footing") 

The text fields inside the quotes can contMn anything, including 

SCRIBE coaiaands. For example, the iPagsHeading coamand used to print 

raost of this document (all but this page, in fact) sas 

ftpageheadingileft "fcCSCBIBE User's Manuall", 
right "acfPage §ref <page}1") 

The §cC...J generates spall capitals (see section 3.3). The SrefCPage) 

causes the current page number to be printed In that spot (see section 

XREFS). 

The IPagebeadinng and fPagefooting coaaaiids may take an optional. 
parameter, IMMEDIATE. If the IMMEDIATE paraaeter is present: 

&PageHeading(I»iadiate,Left=*Left heading",....) 
then the heading of the current page Mill be changed- In the absence 
of the laiediate parameter, the newly-declared heading or footing 

Left footing center footing Right footing 
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»©n*t take effect until the following page. 

5*4- Title Pages 

The document types REPORT and MAMOAL <and their variations) include 
a siiiple mechanism for generating title pages. 

Surround the title page text with a iBeginCTitlePage) and a 
§End<TitlePage). These will cause the title page to be on a page by 
itself , and text within the title page to he centered. 

At CfW, the title page for a technical report should have the titles 
author, and date of publication visible within a "box" that will be 
reproduced on the cover of the report. To put text in this box, use 
the environment "TitleBox". If you do a §8egin{ TitleBox), the next 
line of text will be positioned at the very top of the title box 
region. »hen you 9End<Tl tleBox), text assembly sill shift down to a 
region of the page that is no longer in the title box* To get large or 
aedlua letters inside the title box, use the "Major Heading* or 
"Heading" environments described in section 5.1. 

The emrironuent "Copyright Mot ice" is used to put a copyright notice 
ott the title page. If you type this text into the manuscript files 

fCopyrightloticeCL. Frank 8 sua) 
then SCRIBE Mill put the following line on your title page, at an 

appropriate spot near the bottom: 

Copyright -C- 1918 L. Frank 8au« 

for the current year. 

The environment "Researc.hCred.it" is used to put a research funding 
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credit at the bottoa of the title page- Any text that you put between 
a §Begin{Research€redit) and §End(fiesearchCredit) will be placed in an 
appropriate spot at the bottom of the page, justified and single 
spaced* 

See appendix TXTLEPAGEEXAMPLE for an example of a title page. 
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bg format Control; Tabs, Columns, and Cursor Moveaent 

SCRIBE provides several «ays to get text or numbers formatted into 
coluans. For simple formats or small amounts of tabular material, the 
VERBATIM environment serves admirably. For uore complex formatting, 
typewriter-style tab stops, set in fixed columns, are available? they 
nay fie used in any environment, but FOK1AT is a frequent choice. 

6*1- VERBATIM 

For saall anounts off tabular material, it wight be easiest to format 
"by nand" at the terminal and use the VERBATIM environment. In 
VERBATIM, SCRIBE copies each line of the input Manuscript file to one 
line in the output, and uses a fixed-width font so that characters 
«ili line up correctly. 

For example, if the input manuscript file contains this text: 

fbeginC verbatim) 

Directory listing 26-Jun-78 0:56:57 
lane Extension L«n Prot Access Creation 



AH net 


«AK 


25 


<155> 


24- Jun-7 8 


11:59 


22 A Jun-78 


TEXT 


MAK 


3 


<055> 


24-Jun-78 


0:56 


24-Jun-78 


MCFREP 


MAI 


9 


<055> 


26-Jun-78 


185 30 


24- i JUH-78 


WA80AL 


KAK 


48 


<055> 


25-Jun-78 


22:43 


24-JUB-78 



Total of 85 blocks In 4 files on OSKC: CC410BR103 
•En d< Verba t la > 

then the tiisished docuiaent, when printed, will look like this: 

Directory listing 26-Jun-78 0:56:57 
Naae Extension ten Prot Access —Creation — - 

ARTICL MAR 25 <155> 24-Jun-78 11:59 22-Jun-78 
TEXT MAK 3 <055> 24-J«n-78 0156 24-3un-78 
MCFREP HKK 9 <055> 26-Jun-78 18:30 24-Jun~78 

MANUAL MAK 48 <055> 25-Jun-78 22:48 24-Jun-78 

Total ot 85 blocks in 4 files on QSKCi CC4108R101 

The fixed-width font is important so that columns will line up 
correctly: if me printed that sane text In our normal font {which has 
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different widths for different characters), it Mould come out look! 

like this: 

Oirectory listing 26-Jun-78 0:56:57 
Mane Extension ten Prot Access 'Creation 



ng 



AKflCL 


MAK 


25 


<155> 


24-Jun-78 


11:59 


22-«3un~7 8 


TEXT 


MAS 


3 


<055> 


24-Jun-78 


0:56 


24-Jun-78 


MCFKSP 


MAK 


9 


<055> 


26-Jun-78 


18:30 


24~Jun-78 


nhmkh 


MAI 


40 


<055> 


25~Jun-7 8 


22:4-8 


24-Jun-78 



Total of 85 blocks in 4 files on DSKCs CC410BH103 

6**2. Tabs ana labs Stops 

SCRIBE has a tab-stop aechanlsa that works pretty much the way tabs 
on a typewriter work, Tabs »ay be set in any horizontal position, and 
when a "tab" coaimand is found, SCRIBE will moire right to the next tab 
stop and start formatting there. 

©* 2-1. Setting Tab Stops 

The setting of SCRIBE tabs is very simple. The ATabClear cosmand 

will clear all tabs, and the fTabs coaaand will set them. Thus, the 

sequence 

STabclear 

§Tabs{ llnch,2 inches, 3 inches > 

will clear all tabs and then set new tabs 1, 2 and 3 inches from the 

left margin of the current environaent. 

The ifabDivide command will divide the formatting area into a 
particular number of columns, making thetB however wide they must be in 
order to fit that aany columns on the page. Thus, 

#TabBivide(5) 
Mill set 4 tab stops, each l/5th of the way across the page. The right 
margin serves as the final tab stop. 



SCKIBE USER'S MNDAL PftSE 35 

The §• coasand sets a tab in the current cursor Position. Thus, the 
sequence 

#tabclear 

This line @. is for setting §• tab stops. 

Hill clear all tabs and then set two new tabs. The exact location of 

these new tabs depends on the font in use. The first one will be set 

at the distance that the letters "This line" occupy on the page. 

6-2. 2. Tabbing to a Tab Stop 

The 8\ comffltand tells SCRIBE to move its formatting cursor to the 
right until it encounters the next tab stop. If there is no tab stop 
to the right of the cursor position, then it will be moved to the 

right aargin. 

The "I or TIB character on your terminal's keyboard does not 
generate a SCRIBE tab, but rather is converted into a series of blank 
spaces. 

6.3. Fancy Cursor Control 

This section tells you hoe to do more elaborate cursor control. 
Tftese fancy cursor-control features can he used, for exanple, to 
generate Mierd mathematical formatting. If you don't see ho* these 
features would be useful to you, then they aren't. 

64 3.1. The Saturn Marker 

SCRIBE asain tains a "return marker*** which is a fixed wemory of a 
particular horizontal position on the page. ¥ou set the return Barker 
Py putting "§1" in your text, iherever "§!"■ occurs, the return Marker 
Mill be set to the current horizontal cursor position. 
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Ihenever SCRIBE finite am M §/», it moves the cursor to the return 
aarker. This will work regardless of whether the cursor Has to the 
left or right of the return Barker. 

One use of the return Marker is building super-subscripts? 

AtI#+C13S/§-C53 

generates 

i 
A 
1 
o. 3-2- Centering, Flush Left, and Flush Right 

SCRIBE has cowfflands that sake it take pieces of text and center the« 

or flush them right. Left flush is no big trick. 

to flush a text fragment right, it aiust be flushed "against 1 * 
something. Usually text is flushed to the right margin, 

like this 

hut text can be flushed right against any tab stops 

text flushed 
right 

against a tab stop 

To flush a text fragaent to the right, you have to delimit the 
fragment to be flushed and you have to tell SCRIBE what to flush it 
against, the code n #> M (looking vaguely like a right arrow) says 
"Oegin a flush-right operation". If there is a tab sequence (@\) 
later in the line, then SCRIBE will find the column that the tab 
sequence tabs to, and then flush right against that column position. 
If there is no tab sequence later in the line, then SCRIBE will flush 
the rest of the line against the right margin. 
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fine for an exanple. TMs input t 

#tabdivide<3) 

®>F lushed to right margin 

§>t© tab stop#\ 

§>longer line flushed to different tab stopf\ 

This line starts in the niddle @>and flushes froa here 

produces this output: 

Flushed to right atargin 

to tab stop 

longer line flushed to different tab stop 
This line starts in the taiddle and flushes froa here 

Before talking about the couaands that center, let's talk about what 

we nean by centering- Centering requires that there be a left and 

right Marker of sotas kind, and that the text be centered between thea. 

For example, 

this line is centered in the page 
but 

this is centered in this is centered in 
the left half of the right half of 

the page the page 

SCRIBE uses tab stops and Margins as the reference points for 
centering, if there are no tab stops set, it will always use the left 
and rignt page margins as centering guides. If there are tab stops, 
then SCRIBE Mill use then instead. More detail in a minute. 

To center something, you have to nark the left and right ends of the 
thing to be centered. Mark the left end always with "§=**. you way 
mark the right end with "§\« (a tab), with another «#=», or with 
nothing. If you mark the right end with nothing, then SCRIBE will 
center the entire rest of the line and use the right Margin for a. 
right-hand centering guide. 
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Ihen SCRIBE finds a @= {begin centering) code or a §> (begin 

ftushright) code, it first checks to see if there was a previous 

unclosed gs or §> on the sa«e line. If there was, then SCRIBE 

simulates a g\ code (tab), which closes the previous center or 

rigntfiush code. if this all sounds much too complicated, then 

contemplate the following example, This input; 

ftbeglnCformatJi 
8Tab0ivide(4) 

a§\b§\cg\d 

S=e§\S=£i\§=g|\i=h 

Left§=Ceoter§>right 
kef tgscenter8>right£\ 
ftabClear 

Letti=centerg>right 
tsnd(foraat) 

produces this output: 

a b c d 

« f g h 

i j fc I 

Left Center right 

Left Center right 

Left Center right 

notice that the *e f g h" line and the «i 3 k 1* line produce the sane 
result. Notice also that you stay combine a 1= centering code and a #> 
flush-right code on the saae line, to produce the "Left Center right" 1 
line shown* 

6*4- Controlling Word, Line, and Page Breaks 

scribe soaetiaes decides to break a line at a place that you don't 
likej sometimes it sight break a page between t«o lines that really 
ought to be together on the saae page. This section tells you how to 
get things kept together. It also tells you how to force word breaks, 
line breaks, and page breaks. 
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6*4.1. Controlling lord and Line Breaks 

SCRIBE breaks lines between Moras. To change where it breaks a 
line* we aust change what it thinks is a word- Words are separated by 
blanks, so what wa need is a means of waking SCRIBE think that a blank 
is Part of a word rather than a separator between two of them. A 
blank that Is part of a word is called a significant blank. The need 
for significant blanks arises often in matheaatical formatting. If 
you are going to write x s y, you don't want the x on one line and the 
- Y on another; you want to make the blanks Into significant blanks. 

There are two ways to do this. The sequence «§ " (an § sign and 
tnen a space) generates a significant blank, which is treated by 
SCRIBE exactly as if it were a letter. Thus, you could write 

X» =§ y 
to make a single word out of that equation. For long and complicated 
equations, it gets a bit tedious to put an "| " instead of every 
blank; it's also quite hard to read. SCRIBE therefore provides a 
coaaand that aakes all blanks in its range into significant blanks* 

#«. So 

SwCx ~ yi 
produces the same results as our previous example. 

The f| coaiaand is used to tell SCRIBE that it say break a word at 
that point. If your text contains "Abracadabra", for example, then 
the output docuaent night contain "Abracadabra* printed together as a 
single word, or it night contain "Abra" on one line and "cadabra" on 
the next line, depending on how the line filling happened. 
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If you want to force a line break to occur before it otherwise 
wight, use the **§*" coaaand. When SCRIBE is Justifying text and coaes 
across an M g*», it will start a new line without justifying the old 
otie. If SCRIBE encounters a «•§*» while processing unjustified text, 
it will be treated as if It were an end-of-Iine. 

614.2* Controlling Page Breaks 

Soraally SCRIBE Mill start a ne« page when the old one is full, 
regardless of what it is doing at the tlae. If SCRIBE happens to be 
processing an insert at the aosient that the page becoaes full, the 
insert sill be split across two pages. It is often desirable to ensure 
that an insert will not be split across a page. There are two ways to 
proceed if an insert will not fit on a paqe'* start a new page Cleaving 
blank space at the bottom of the previous page), or "float" the insert 
to the top of a nearby page and continue the text uninterrupted at 
that point. Both of these options are available In 3CEIBE- To ask 
for then, you need to use the iong-fom insert specification Cwith 
tsegin and gEnd). 

To allow an insert to float if it won't fit on the current page, add 

the keyword FLOUT to the gBegin marker: 

$8 eg in < Vers e, Float) 

Text of verse 
SEnd (Verse) 

If the verse insert won't fit, the text will continue without 
interruption, and the insert will appear on the top of the next page. 

To reguire that a new page be started if an insert doesn't fit on 

the current page, use the keyword GROUPS 
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S8egin<Display,Sroup) 
Text of display insert 
SEnd (Display) 

Tfte fflllGB command say be put into a GROOPed insert to allow it to be 

brokers at that point- If one or wore §Hipge commands are in a GROOPed 

insert, it will be treated as a sequence of snail er inserts* each one 

being G80irped. One way of viewing the 9HIK6E coaaand is to view it as 

being equivalent to a gEitd followed by a fBESIM, gHIMGE will be 

ignored if it appears anywhere but inside a fiROBPed insert. 

If you would like to force a page break to occur prematurely, use 

toe §SEtfP.ISE coiiand. "8HEMPiCE M causes SCRIBE to start at tbe top of 
a new page- »*SSEMPlGEChow aarty)** causes it to leave <bow aany> blank 

pages, then start at the top. of a. new page- 
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?* Cross Reference, Bibliography, and Citation 

SCRIBE does automatic bookkeeping of cross references of various 
kinds. One kind of cross reference is the bibliographic citation, a 
reference to something mentioned in the bibliography. Another kind of 
cross reference is the text reference, which is a reference to souse 
other part of the docuaeiit. 

7il* Cross References 

A cross reference is a notation like "see page 13* or "see chapter 
5". If you are typing a document by hand, it is a aajor feat to get 
cross references right? and if you change anything, they are suddenly 
wrong again. The Joy of Cooking, an 800-page kitchen classic, 
averages 1 to 8 cross references per page, ie shudder to think of the 
work that it took to get all 5000 to 6000 of then right. 

SCRIBE Mill do cross referencing automatically, by letting you 
define codewords to nark places in the text, then filling in the 
correct page or section number wherever you reference the codeword. 

There are two separate kinds of cross references, but their use is 
nearly identical. You nay refer to the page or section number 
containing a piece of text, or you say refer to a specific equation or 
theoreas or exaasple by number. These are called text references and 

object references respectively. 

7<rl*l. Text Inferences* the ©LABEL Coaaand 

The mechanism for text references is quite staple. If you put the 
sequence 8LABELI Codenord}# for sosie codeword that you choose, anywhere 

in a document, SCRIBE will note the page and section number at the 
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spot where the @Lat»el appeared- If you put iREFCCodeword) soaeuhere 
else, SCRIBE Kill fill in the section nustber of the text that contains 
the corresponding gLabel; if you put §PAGEREF(Codevord), SCRIBE all! 

fill in the page number of the corresponding label- 
to take an example fro* this manual, we said on page 21 that 

--- each line In which a @f*C command (see section 7.1, page 

42 appears) - 

the nanuscript file text that generated that line actually contains: 

•-- each line in which a §TAC command (see section 

iref(Xrefs), page fpageref (Xref s> appears). 

Someplace in chapter 2 there is a §Lab«l (Manuscripts) command. 

"Manuscripts" is a codeword that was picked more or less arbitrarily 
to stand for that chapter- ¥ou must choose your own codewords and 
spell then the sane everywhere- 

If a S8EF at the beginning of a document references a gLABEL at the 
end, ScaiSE will use the page number that was generated the last time 
the document was processed* 

If you have made changes to a docuaent, some of the cross references 
wight oe wrong the first ti»e you SCRIBE it after waking those 
changes. If this happens, SCRIBE will tell you? you then have the 
option of printing the file as- it stands (with the errors, but knowing 
that it's not your final copy and that you don't need perfection), or 
ot re-running SCRIBE to get the cross references right- They will be 
right the second tine because the correct values for all labels will 
have been stored in an auxiliary file, which SCRIBE will read in 
before the second processing- Since the nomal evolutionary 
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development of a document involves alternate editing and reprocessing, 
the references Mill be correct almost all of the time, and if you want 
perfection or a particular run, it is staple enough to run it through 
twice. 

SCRIBE builds an "MX" file that contains the various pieces of 
information that it must remember from one run to the next. 
Cross-reference labels are included in this AM file* If you are 
processing a file naaed, say, "KECIPE.MSS", then SCRIBE sill store Its 

auxiliary information in a file named "RECIPE* AUX". 

7-1.2- Object References! the §TAS Command 

One of the »ost valuable features of SCRIBE is its ability to number 
things for you, and thus to renumber If changes are made. Automatic 
page numbering Is pretty auch taken for granted; we have already 
mentioned the automatic numbering of sections CSection 5.2> and of 
equations or theorems {Section 3-4.2), SCRIBE *ill. number anything it 
can count? you can also attach a cross-reference tag to anything that 
SOU B£ can count. 

Let's talk about the difference between the gLabel command and the 
#tag command? this difference is a bit subtle. A sectioned document 
has many different sequences of numbers that identify the pieces of 
it. Pages are numbered sequentially? chapters and sections and such 
are usually numbered independently of the pages. Figures and tables 
are often nuabered within a chapter, ignoring section numbers. If you 
want to attach a codeword to the section number of the section that 
contains a particular theorem or example or figure or table, then use 
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fLabel. if you want to attach a codeword to the theorem number or 
exaaple number or aquation number* rather than to the section that it 
is contained in, use the §Tag cowaand. 

It's tise for some examples. You should reaseaber fro« section 3.4.2 
ttiat the THEOREM and EQOATIOH environments are used to print theorems 
and equations and automatically to assign numbers to then. You nay 
Place an §lag cowaand inside a THEOREM or an EQUATION to define a 
label so that you may reference the equation or theorem number. You 
nay also place a §Label consand inside a THEOREM or an EQUATION so 
that you asay reference the section number or cage nuaiber on Hhich the 
theorem or equation occurs. 

This unlikely input texts 

eoeginKTheore©) 

ttagtisbed) 

§1 ab el C IstfeedSec) 

If € is a non-self -enbedding context-free gramiar, then 

LIS) is a regular set. 

§End< Theorem) 

It follows Ianediately from Theorem §ref{I»bed), that ... 

Cand in a later section... 3 
Me showed in section gref (IssbedSec) in Theorem iref (iwbed> ... 

Bight produce this output text J 

Theorea 4*10; If 6 is a non-self-esibedding context-free 

grammar, then L(S) is a regular set. 

...It follows immediately froa Theorem 4.10, that ... 
tie showed in section 4.6 in Theorem 4.10 ... 

7.2. Siniiography and Citation 

k bibliography is a labeled list of books, articles, papers, and the 
like. A citation is a Barker in the text that refers to an entry in 
the bibliography. Thus, if a section of your bibliography looks like 
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this: 

C1SJ E. I. Diciest ra. Co-operating Sequential Processes. In F. Senuys, 
editor, Programing Languages, pages 43-110, Academic Press, 
1968. 

C161 fiary-CIaire van Leunen. A Bankbook for Scholars- Alfred A. 
Knopf, 1978. 

till A. van Mijngaarden, B. J. Mailloux, J. E. L. Peck, and C. H. A. 

Koster. Report on the Algorithmic Language ALGOL 68* Mathenatisch 
Centruw, Ansterda^, 1969. 

then text with citations might look like this: 

M. van Leunen, in her lively and detailed book, argues 
against the bibliographic footnote E161. 

Tne original language, which «as rather «ore cumbersome to 
learn and to use, is defined in van iijngaarden et al C171. 

the SCRIBE bibliography facility does three things: 

1- Selects frost a database the bibliographic entries that are 
actually cited, 

2. Formats then? into a bibliography and assigns a number or 
label to each, and 

3. Causes the correct numbers to be placed in the citations in 

the text. 

7,12.1. Bibliography Files 

Because SCRIBE selects and prints only those entries in a 
bibliography that are actually cited in the text, you may use a coaaon 
bibliography "database*' for »any different documents, this database Is 
in a separate file which «e will call the bibliography file. Each 
entry will be given an identifier, or name, by which it is cited, 
these identifiers work in very such the same nay as do the §label/@ref 
cross-reference keywords <see section 7.1): an identifier is defined 
in one place Cthe bibliography) aad cited in others Cicite commands in 
the text). 
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The bibliography file thus consists of a series of entries* each 
with an identifier. Each entry also has an entry type and a list of 
data fields. For example, the bibliography file entriss for our 
examples of the previous section might be 

»In8ook(Processes* Author "B. tu Dijkstra*** 

Title "Co-operating Sequential Processes*"* 
Editor **F. Genuys*** 
Title "Programming Languages •** 
Publisher "Academic Press"* 
) 
»8ook{H*4$DBOOK* Author "Mary-Claire van Leunen", 

Title »a Handbook for Scholars"* 
Publisher "Alfred A. Knopf", 
Date "1978" 
) 
9Report(ALeQL68,Author "A. van lijngaarden* B. J. Mailloux* 

J. E. t. Peck* and C. 8. A. foster*** 
Title "Report on the Algorithm ic Language ALGOL 6 
Publisher "Hatheaatlsch Centrum* Amsterdam*** 
Bate "1969" 
) 

In tnis example, the names "Processes*** "HftUDBOOK"* and "ALG0L6B" 

are the Identifiers by which these bibliography entries will be cited. 
Tfte text ot the document would contain gCite commands that reference 

tnosa identifiers. 

Any text following a bibliography file entry is assumed to be an 
annotation or commentary on that entry* and will be included in the 
orbitography printed in your document. 

7*2.2- Citations 

Citations are simple. Just put a fcite cosaand into your text at the 
spot where the citation should appear. fCite takes one or more 
identifiers to tell it what to cite; 

§cite<Knuth59) 
§clte<€uarino78*Cooprider78) 
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These will be processed by SCRIBE into standard form citations: 

CI 21 
C5,163 

7.2.3- Alternate Citation Styles 

Soffle people don't like straight numeric citations, though it is the 
for® asost frequently needed in preparing pacers for publication, 
SCRIBE tries to have something for everyone, though, and therefore 
provides a style parameter to change citation style. ¥ou »ay choose: 

1. Straight nuaeric citation. This is normally the default: 

to 3. 

2. author's last naae and year: CSuarino783. 

3. First 3 characters of author's last name, and year: CGua783. 

4. Print the identifier instead of a generated label- 

*ou aay set the bibliography style using the CITATIQM parameter to the 
SStyle coiiKand: 

8StF.le{CITafI{M=13 or #Style(CIf ATIORM), etc. 
Some docuaent types may include a specification of CIT*TI0M style of 
other than l; this is Mhy »e said that style 1 Is normally the default 
rather than style 1 is the default. 

7*2.4. wits and Bolts of Bibliography Entry Format 

As we said earlier in this chapter, a bibliography file is a 
sequence of bibliography entries, each possibly followed by an 
annotation. This section describes the detailed for»at of these 
entries. 

Eacti bibliography entry takes the form 
§what( identifier, infortsation list) 
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where -what" i s ane c f BOOK, ARTICLE, TRESIS, ITOOOK, REPORT, or MISC. 
The *" information list" is a list of data about the entry, each datum 
consisting of a parameter word and a quoted string- Each type of 
entry needs a different set of information- For example, an ARTICLE 
needs a JOURNAL parameter, while a THESIS needs a SCHOOL parameter. 
The complete set of parameters is; 



AUTHOR 

JOURNAL 

ISSUE 

¥OL!IME 

DATE 
TITLE 

BOOKflTLS 

EDITOR 

PAGE 
SCHOOL 



The name of the author or authors. Put names in the 
order "First I. Last" and not "Last, First I.". 

The title of the journal or its standard abbreviation* 
The number within volume of the Journal issue. 

For journals, the journal volume number* For 
Multi-volume books, the book volume number* 

The publication date. 

The title of the article, paper, book, or thesis being 

cited. 

If a chapter of a book is being cited, the book title 

must also be given. 

If a chapter of a book is being cited, the name of the 

editor of the book mus be given. 

If desired, a page number or numbers may be provided. 

The name of the school at which a thesis was 

submitted. 



If an unnecessary parameter is included in an entry, it will be 

ignored. If a necessary parameter is omitted from an entry, a warning 
message will be issued when the file is processed. 
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8. Figures and fables 

Figures and tables are inserted into the Manuscript file in very 
much the same say as any other kind of insert; you mark the beginning 
with a @8egin or gBegin* and nark the end with an §End or §End. 
Between those delimiters you place the coaaands necessary to produce 
the figure- 

A figure has three parts: 

1- A figure body, the figure body cars be something you paste 
onto the finished document, it can be an image picture 
printed on the XGP. It can be text produced with SCRIBE. 
How you produce it is your own business. 

2, A caption. All figures must have captions. ¥©u provide the 
text of the caption* and you decide how It Is to be placed 
with respect to the figure body. 

3. A figure number. Figures are numbered sequentially. SCRIBE 
will automatically assign numbers to figures* and you can 
use the standard SCRIBE cross-reference aechanissa Csee 
section 7.1) to refer to then. 

8*1. Generating Figure Bodies 

You «ay generate the body of a figure using any of the standard 

SCRIBE environaents* such as FORMAT* VERBATIM, or EXAMPLE. You stay 

also generate the body of a figure using the special coeaands 

iBlankspace or §Picture. the §Blankspace coisnand leaves a blank space 

in your docunent* the ^picture command (which works only on the XGP* 

and then only on the Cfflf XGP) inserts an image picture into the 

1 
docuaent • 

Figure 8-1: Sample Iaage Picture 

1 
Ifflage pictures are binary files produced by the SPACS prograu* the 
PLOT program* and others. These programs are mentioned in the CMB 
Introductory Users* Manual and are fully documented in other nanuals. 
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8*1.1. The 8-8 lank space Command 

the fBlankspace comand aakes a blank space of a. specified size. 

fBlankspaceO Inches) Bakes a blank space about 3 inches high? 
9Blankspace(16 c») makes a blank space about 16 centimeters high- Me 
say "about", because SCPT8S Mill always leave a saall margin above ana 
below the blank space that you request. tou may use the distance 
units "inches", «in«, "inch", "on", "aw", or "lines". If you specify 
the a»ount of blank space in lines, then the amount that you actually 
get »iii depend on the font and printing device being used. 

811.2. The ^Picture Coaraand 

Tfte SPlcture conaaitd needs t«o arguments; the size of the iaage 

Picture, measured in XSP scan lines, and the na«e of the POP-10 file 

that will contain the iaage picture at the tine you are printing the 

docu»ent on the X&. ft typical fPicture coamand might bei 

§Picture{622,FIle "TEMPI I08US.IMSCF100CH001") 

this command will generate an iaage picture that is 622 scan lines 

high (about 3.4 inches), and whose definition can be found in the file 

1 
"TE«PM010S.IM€« on the account F100CH00 . 

8 J 2. Generating Figure Captions 

Figure captions are generated uitn the iCaptien command. The call is 
Just 

1 
Cm Computer Science Department users please note: the file nase 
and PPS specified here are evaluated on CH0-10B, regardless of which 
machine you run SCRIBE on. If you have different account numbers on 
different Machines, «ake sure that you use the 10-B account numbers in 
tne fPicture coaaaad 



SCHIBE USEK'S MANUAL PAGE 52 

8Caption(fext of Figure Caption) 
SCRIBE Mill add the word "Figure" and the correct figure number; what 
■111 get printed in the finished docusent will be something like; 

Figure 3-6: Text of Figure Caption 

m 

*M3. Figure iuabers 

Figures are nuabered automatically during the processing of the 

@C apt ion co»*and. If you don't put a caption on a figure, it won't 
get a nuaber. If you want to reference the figure In the text of the 
document, you Mill want to put a§Tag command into the body of the 
figure- The best place to put the §Tag is after the gCaption- If you 

put it before the fCaption, you will -get the wrong figure number 
assigned to the tag* because the number will not ?et have been 

lncreaented. 

8a4. Full-page figures 

It you «ant to make sure that a figure occupies an entire page, use 
the FLOATPAGE attribute to the § Beg in (Figure); 

§begln<Figure # FioatPage) 

<figure body> 
iCaptionCf igure caption) 
gsnd (Figure) 

The figure will be given a page to itself. If you want the caption at 

the bottoa of the page, you asust put in the right amount of spacing 

yourself. 

If you want to leave a blank figure page In the document, use the 
HBlankpage conaand: 

#Blankpage<l) 
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will leave one blank figure page. This figure page Mill have page 
headings and footings , and will be given a page nu»ber# but nothing 
Mill be printed on it. 

you «ay reaeasber that there is a §Ie«page coaaand {section 6.4.2> # 
which starts a new page and can leave a specified number of blank 
pages, fsiankpage differs from SNewpage in a subtle but iaportant way- 
ihen SC8IBE encounters a §Me«page coiraand, it skips iwaediately to the 

top of the ne&t page. Mhen SCRIBE encounters a §81ankpaga command* It 
aakes a note about the blank page reguest but continues on the current 
page; then when it finally cones to the end of the current page* it 

will put in the extra blank PageCs) at that point. 

The sequence 

iBeginCFigure^FloatPage ) 
§End (Figure) 

Mill yield exactly the same effect as 

fBlankpageCl) 
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9* Making Changes to Standard Formats 

Although SCRIBE'S basic approach to document production is to 
provide its users with a large aenu of document types and discourage 
then fro« tinkering with details, no recognize that the urge to tinker 
is incurable- SCRIBE therefore provides two coamands that may be used 
to Make small changes in the format and style of a document. 

9*1. the gFont Coaaand 

The gFont coaaand tells SCRIBE to use a particular type font. To us, 
a type font is a collection of type faces, chosen to look haraonious 
when used together. A font Mill often contain 10 to 15 different type 

faces in diferent sizes and styles. For example, a typical font will 
contain woman. Boldface and Italic In both body text size and footnote 
text size? it will also contain various sizes of heading and title 
fonts, usually without italics and boldface. A font, like a docuaent 
type, is defined by an entry in SCRIBE'S database, this font database 
entry is a list of indorsation of the fori "when I say @B, I aean 
Tiaes Rowan Bold; when I say §R, I mean Tiaes Roman Medium." An entry 
like that would be found in a font whose naae Has "Times Roman", which 
would »e specified by the coaaand §Font(TlnesRoaan). 

942. A List of Available Fonts 

fit cm at the tine of this writing {July 1978), the following fonts 

are available for use with SCRIBE. Many different character-set files 
exist for the XGP, but very few of thea are attractive enough and 
readable enough to warrant printing a document in thea. Each SCRIBE 

font uses 10 to 15 different character-set files. 
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Here is the list; a sample of each Is in appendix FOMf SAMPLES: 

MewsCothiclO 
lfevsGot!iicl2 
Mont el 2 
Uonie9 

Meteor 12 

.MeteorS 

BodonllO 

fhe number associated with a font is its height in "points", which is 
a unit of printer's neasure* A 10-point type like Hews Sothic 10 is 

about the sa«e size as a standard Elite typewriter font. 

For fliablo printers, a font si«ply specifies a type wheel and a list 

of special characters to he constructed with it; SCRIBE knows about 

these fonts (typewheels) for the Diablo: 

Elite 
Pica 

Although users say create their own fonts by creating their own 
database entries, we defer description of this process to the Expert's 

Manual, 

9»3. The estyle Coanand 

The iStyle comand changes the settings of certain of SCRIBE'S 
internal parameters. These paraneters fora a sort of "genetic code"; 

each parameter is somewhat like a -gene. There is a parastter that 
controls whether or not SCRIBE snakes a flush right margin. There is a 

parameter that controls how wuch space SCRIBE leaves between lines; 
another that controls the distance that each paragraph is indented- 

fhe database entry for a document type presets the value of all 
SCRIBE parameters. ¥ou nay use the IStyle coanand to override these 
values- All IStyle comaands used in a document aust cowe at the 



SCHIBE USER'S MANUAL PAGE 56 

beginning? you can't change styles In fflid-docuaent. 

Let's consider a snail example, the document type TEXT specifies n© 
paragraph indentation; it adds an extra blank line between paragraphs 
instead, if you wanted to change to standard typewriter-style 
indentation {5 spaces), you could put the coaaand 

$sty ie< indentation^) 
into your manuscript file. SCRIBE would then indent paragraphs 5 
spaces. If you also wanted to suppress the extra blank line between 
Paragraphs, you could say 

tStyieC indentation 5, Spread 0) 
or alternatively you could say 

f?Style{ Indentation 5) 

#Sty.le<Spread 0) 

The word "Spread" was chosen to aean inter-paragraph spacing solely 
because it would be pretty tedious to type 
§styie< Inter-Paragraphspacing ) . 

Some style parameters expect na»es Instead of numbers? others expect 
quoted strings. For example * 

iStyleCdustification Off) 
will turn off right-aargin justification, while 

»StyIe(Pootnotes "*") 
tells SCRIBE to use asterisks instead of nuabers when counting 
footnotes. 

y.4. A List of STYLE Paraaeters 

ffcis table is a partial listing of SCRIBE'S various style parameters 
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Spacing 



and an explanation of ahat kind of value they expect, the complete 
list, which contains «any obscure and exotic parameters, is in the 
Expert's Manual. These parameters are used in the f Style command, 

Hiilch is explained in the previous section. 

Indentation Controls paragraph indentation, k horizontal distance 

should be provided: 

fSfyleC Indentation 5) 

weans to indent 5 spaces. If you want backwards 
indentation, give it a negative number. 

Controls inter-line spacing* A vertical distance 
should be provided! "2" aeans "2 lines", i.e. double 
space. If you want, say, one-and-a-half spacing, then 
say 

iSty'let Spacing 1.5) 

The default spacing that you get depends on the 
document type being produced. 

Controls the inter-paragraph spacing, i.e. the extra 
space, over and above the line spacing, that «ill be 

put between paragraphs. 

* "Yes", "Mo", "On", or "Off" tells SCRIBE whether or 
not to justify the right margin. Don't put the word 

in quotes: 

§Style{Justification Off) 
SStyleCJustification On) 

This parameter Mill change the size of the l«ft margin 
of the pages. For example, 

#StyIe {Left Mar gin 1.3 inches) 

will cause the page to have a 1.3-inch left margin. 

this parameter will change the size of the right 
margin. The RightMargin parameter and the Paperiidth 

parameter both affect the length of the printed lines. 

Changes the top nargin of the page. 

Changes the bottom nargin of the page. The 
BottoaHargin parameter and the PaperLength parameter 

both affect the size of the printing area on the page. 



Spread 



Justification 



Left Margin 



Right-Margin 

Top Mar gin 
BottomHargin 
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Paper Length 



Paperfidth 
Footnotes 



Used to specify the length of the paper that yon are 

using. For example* 

SStyle (Paper Length 14 Inches) 

specifies legal^size paper. 

Used to specify the uidth of the paper that you are 
using. 

Controls the way that footnotes are numbered. The 
normal numbering schese is numeric: the first footnote 
is numbered *'1 ,, # the second one -7 n , and so forth. 

SStyle<Footnotes «*") 

Mill cause the numbering to be »*« # «**«, aJJ j so 
forth. If you want some other numbering scheae used, 

specify a template. See the Expert's Manual to find 
out «hat that means. 
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10- Producing Large Doctwents 

SCRIBE has several features that make it easier to work on large 
documents. The SFile command allows a document to be split into 

multiple files, which makes editing and storage easier- the gString 
command allows you to store freguently-used text strings and reference 
them by naie. The gPart command facilitates separate compilation of 
parts of a larger document. The gOse command tells SCRIBE to use a 
Particular set of database files or a particular bibliography or .AUX 
file* 

10.1, Including Subfiles in a Manuscript File 

SCRIBE normal iy reads sequentially through a manuscript file, 

processing text and commands as it coses to them. The fFIle command 

wakes SCSI BE suspend processing of the main manuscript file, process a 

second file, then resume processing of the original manuscript file. 

For example, if your Manuscript file contains 

00100 The Micked Hitch was both surprised and worried when 

00.200 she saM the nark on Dorothy's forehead, for she knew 
00300 well that neither the Hinged Monkey nor she, herself, 
00400 dare hurt the girl in any way. 
00500 8Flle{5UBFIL.MSS£C410BIll03) 

OOfcOO At first the With was tempted to run away from Dorothy; 
00700 but she happened to look into the child's eyes and saw 

00800 boa simple the soul behind then Mas, and that the 
00900 little girl did not know of the wonderful power the 

01000 Silver Shoes gave her. 

and if the file whose naae is S0BriL.ifSSC€41OB810J contains 

00100 She looked down at Dorothy's feet, and seeing the 
00200 Silver Shoes, began to triable with fear, for she knew 

00300 what a powerful charm belonged to them. 

then the finished document will contain the text 

The licked Mitch was both surprised and worried when she saw 
tbe mark on Dorothy's forehead, for she knew well that neither 

the Hinged Monkey nor she, herself, dare hurt the girl in any 
way. She looked down at Dorothy's feet, and seeing the Silver 

Shoes, began to tremble with fear, for she knew what a 
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powerful charm belonged to them, it first the lith was tempted 
to run a«ay fros Dorothy? but she happened to look into the 

child's eyes and saw how siapie the soul behind the* was* and 
that the little girl did not knoH of the wonderful poser the 

Silver shoes gave her. 

IFile commands «ay be nested* i.e. a file that is processed because 
of a SFile coaatand »ay itself contain other fFiie commands naming yet 

«ore files. 

10-2. Defining and Using Text Strings 

the SString command provides a aechanism for storing a series of 
characters under a Particular name, then including that series of 

cnaracters in the docuaent by referring to the name in a SRef command. 

10.2.1. fhe fString €o«*and 

fString defines naaes to equal a quoted strings 

0String<CACM= M CoaaiiFications of the ACM*) 

2 2 

§3tringCEQ4= M x *4*x*y-17*y ") 
SString<Sa»e="J. Alfred Prufrock", &§ency= M Putabaga, Inc.") 

¥ou neeo not use quotation narks; any of the delimiters described in 

section 3.1 will work. fo use these text strings that you have 

defined, call then inside a fief coiraand- For example, if the gstring 
commands of the previous example have been processed, then this input: 

Prior sort was published in 8ref<CACIO« 

fhe solution is gref<E«4).. 

§Raf (Haste) no longer is employed by §ref (ftgency). 

will produce this outputs 

Prior work was published in Con»unications! of the ACM. 

2 2 

The solution is x +4*x*y-l'1*;y 
J. Alfred Prufrock no longer is eaployed by Rutabaga, Inc. 

If both a text string and a cross-reference label are given the same 

name, then the fief will refer to the text string and not to the 
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cross-reference label. 

10.3.. The f.part Coaaands Separate Compilation 

10.4. The gOse Couands Changing the Processing Environaent 



SCKIBE USER'S MANUAL PAGE 62 

,ti a Potpourri of Examples 

This appendix is full of random examples- All of them were 
motivated because early users of SCRIBE often asked, **Ho« do I do 
such-and-so**. There is no particular logic to the sequencing of these 
examples* 

gftPpendixsec(Ho« to Pake a Title Page) Document Types REPORT, 
MANUAL* and ARTICLE contain a title page facility? you can also say 
and produce just the title page. 

This input file produced the title page for this manual: 

#begin<TitlePage) 

8begin(TitleBox) 

8NajorHeadingC5CRZBE 

introductory 
User's 

.Manual) 

SHeading (First Edition) 

Brian K. ieid 
frefCDate) 

eendCUtleBox) 
vbeginCBeadin?) 
Carnegie-Mellon University 
Computer Science Department 

§£nd(Heading> 
@CopyrlghtNotice(Brlan K. Reid) 

S8eg. in (ResearchCred.it) 

The research that produced SCRIBE was funded in part by the 

Rome Air Development Center under Contract lo. F3O6-2-7$-C~021 

and in part toy the Defense Advanced Research Projects Agency 

under contract lo. F44620-73-C-CQ74. 

iEndCRes earchCred.it) 

§End(Titiepage) 

The *»Titlepage M environment will be on a page by itself f i.e. a page 
break ulll be taken before It and after It. The "TitleBox" environment 
is used to line up text with the box on CMC technical report covers- 
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Anything that you put inside the environaent "TitleBox" will be 
positioned on the page so that it will show through the cutout box. 

The "ResearchCredit" environment puts justified text at the bottom 
of the title page. The «eopyrightIotice" environment generates the 
centered notice, and positions it in a particular place on the page. 
»AppendixSec(Eguations and Cross References! This example is taken 
from Volume 1 of The Art of Computer Programming by Donald E. JCnuth. 
It shoes the use of the SCSIBi equation nuubering scheae, and it shows 
the use of cross-references to equations earlier in the text. 

Here is the input files 

Let 8i£p{n)J be soae statement about the integer giCn3; for 

exauple, giCP(n)] sight be "film tines CliCn3 * 3) is an even 

nusibsr,« or "if @itnl ?> 10, then 2g*t§it«33 > 8i£n3e»£33. M 

Suppose «e want giCto prove that P(n) is true for all positive 

integers ml* In important way to do this is: 

fSeginCEnuaerate) 

Give a proof that §ICP(1>3 is true? gTagCBaseStep) 

Give a proof that "if all of gitPlCl), §iCP3(2), , . . , 

gitP3<§itn3} 
are true, then 8iEPl(fiCnl+l) is also true"; this proof should 

be valid 
for any positive integer firm. iTagCf nductstep) 
iEndCEnuaerate) 

As an example, consider the following series of equations, which 
■any people have discovered independently since ancient tines 2 
9«quation< 
1 = 1S+C23, 1 + 3 = 26+C23, 1 + 3 + 5 = 3|+C23, 1+3+5+7= 

48+C23* 
1 + 3 + 5 +~7 *' 9 = 5P+C23. 
) 

He can formulate the general property as follows: 
feguationC 

1 + 3 + . . . * <2§iCn3 - 1) - fi£n38+C23 «Tag< Induction! 
1 

Let us, for the aoaent, call this eguatiot; 8ifP<n)3; we wish to 

prove that §iCP<n)3 is true for all positive §iCn3. Following 

tfts procedure outlined above, we have: 

08egin(Enwerate) 

w liCP3Cl) is true since 1 = 1@*C23.« 

"If all of §i€P3<l>, . . . , «lCP3(eiCn3} are true, then, in 

particular, 
8iCP3<§iCn3) is true, so Eg. fRef (Induction) holds? adding 
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2gitn3 + 1 
to both sides, we obtain 
f begin { equation) 
1 + 3 + . • . + <2%ltnl - 1) + (281 Cnl + 1) = §iCn3$+C23 * 

26lCnl ♦ 1 = (HiCn! ♦ l)§+t23 
§EndC equation) 

which proves that itCPlCiiCnl * 1) is also true." 
8£nd(Enuaerat«) 

We can regard this method as an Sltalgorlthalc proof procedure!. 
In fact, the following algorithm produces a proof of 

§ICP3C81Cn3) for 
any positive integer §iCnl # assuming that steps |8ef CBaseStep) 
and §Ref< Inducts tep) above have been worked out. 

and here is the output that if produces; 

Let Pin} fee soae statement about the integer n; for exaaple, P<n) 

n 
might be »n tiaes (n + 3) is an even number," or "If n ?> 10, then 2 
3 

> n .** Suppose we want to prove that P(n) is true for all positive 
integers n- An important way to do this isf 
1. Give a proof that P<1) is true; 

2- Give a proof that "if all of PCD, P<2), ... , p(n> are 

true, then p(n+l) is also trye"j this proof should be valid 

for any positive integer n. 

As an example, consider the following series of equations, which 

atany people have discovered independently since ancient times: 

2 2 2 2 

1 = 1,14-3 = 2, 1+3 + 5 = 3,1 + 34 -5 + 7 = 4, 

2 
1 + 3*5 + 7+9 = 5. 

He can formulate the general property as follow si 

2 
1+3+.. .+ C2n - 1) = n <1) 

Let us, for the woment, call this equation PCn>? we wish to prove that 

P<«) is true for all positive n. Following the procedure outlined 

above, we haves 

2 

1. "PCD is true since 1 = 1 ." 

2. «if all of PCI), ... , P(ii) are true, then, in particular, 
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P(n) Is true, so Eg. 1 holds? adding 2n * 1 to both sides, 
«e obtain 

2 
1 + 3 + , . , + (2n - 1> + <2n + 1) = n ♦ 2n + 1 s 

iffiich proves that P{n + 1) is also true.** 

Is can regard this jaethod as an algorithmic proof procedure* In 
fact* the following algoritha produces a proof of p(n) for any 

positive integer m, assuming that steps 1. and 2, above have been 
»orfced! out. 
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II. Special Characters 
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III. font Samples 

fttls section contains samples of sons of the ISP fonts, to sho» you 
what they look like, Re»euber that exotic and intricate fonts,, 
however showy they might be, are very hard to read unless you have 
only a very few vords on the exotic font. 
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8 sign as a character 

% sign, seaning 6 



i! 


coaaand 


35 


m 


coaaand 


10 


§* 


coaaand 


40 


8* 


coanand 


15 


8- 


coaaand 


15 


8. 


coaaand 


34 


8/ 


conaand 


35 


g= 


coanand 


37 


H> 


coaaand 


36 



§&ppendlx coanand 29 

Slppandixsection coanand 29 

§8 coaaand 14 

iBegln coasand 15, 16 

SB lank space command 51 

SC coanand 15 

gCaption coaaand 51 

SChapter coaaand 29 

SCite coaaand 46, 47 

flievice coaaand 8, 25 

@End coanand 15, 16 

IFile cooaand 59 

gFont coaaand 25, 26 # 54 

§€ coanand 15 

fefiinge coanand 41 

81 coaaand 14 

SIndex coamand 23 

SLabel coanand 42, 46 

$Kake coanand 25 

§ia»page coaaand 41 

iO coaaand 14, 15 

§P age ret coaaand 43 

^Paragraph coaaand 29 

SPicture cow and 51 

SPrefacesection coaaand 29 

m coaaand 15 

8R«f coaaand 22, 43, 46, 60 

IS coaaand 14 

SSection coanand 29 

f String coamand 60 

£Style coaaand 25, 26, 55, 56 

fSubsection coaaand 29 

§f coaaand 15 

ifa.oc.lear coanand 34 

§fafos coaaand 34 

flag coaaand 21, 22 

ffheorem coaaand 22 

SO coaaand 14 

S«n coanand 14 
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dUrmuiebered coaaand 29 

§0x constant 14 

#» cosaand 39 

#\ consand 35, 37 

91 coaaand 39 

Alphabetic space 10, 39 

Annotation in Bibliography 47 
ARTICLE bibliography entry type 48 
ARTICLE document type 25, 62 
ARTICLS1. document type 25 
AUTHOR bibliography entry parameter 49 
MIX files 44 

Bibliographic citations 42 
Bibliography 45 

Bibliography annotation 47 
Bibliography database 46 
Bibliography entry 48 
Bibliography entry paraseters. 49 
Bibliography entry selection 46 
Bibliography entry type 47 
Bibliography file 46, 48 
Boldface, how to get 14 
BOOK bibliography entry type 48 
BOOKTITLE bibliography entry parameter 49 
B0TT0MM.a8S.IM style parameter 57 
Bracketing 12 

Captions for figures 51 

CENTER environment 16, 18 

Centering 37 

Chapter titles 28 

Character fonts 10 

Characters 66 

Citation 45 

CITATIGS style paraaater 48 

Citation styles 48 

Citations 42, 47 

Clearing tab stops 34 

Codewords 42 

Coluan formatting 33, 34 

Copyright notice, ho» to produce 31 

CopyrigntHotI.ee environment 31, 63 

Cross reference codewords 42 

Cross reference example 43 

Cross references 21, 42, 46 

Cross references, errors in 43 

Cursor control 35 

DATE bibliography entry paraaeter 49 
Delimiters 12, 15 
Delia iters, nesting 13 
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DESCRIPTION environaeni 17, 20 

devices 14 

Diablo 55 

Diablo output 8 

DISPLAY environment 16, 17 

Docuaent file 7 

Document types 24 

Docuaent types, how to define 25 

Document types, hoa to .modify 25, 54 

Docuaent, definition off 3 

Double-spacing 57 

EDITOR bibliography entry parameter 49 
E»UME8ATE environment 17, 19 
EQUATION environment 17, 21 

Equation number references 42 
Equation numbers 44 
.Equations, exaaples 63 

EXAMPLE 16 

EXAMPLE environaent 17 

Example number references 42 

Figure bodies, generating 50 

Figure captions, generating 51 

Figure nunbers 52 

Figures, how to sake 50 

File output 8 

Fixed-width fonts 33 

FLOAT parameter 40 

Flush right 36 

Font height aeasureaent 55 

Font-change copies 14 

Fonts 10, 14, 33, 54, 55, 67 

Fonts, ho» to create 55 

Footnote numbering 56, 58 

Footnote numbers 23 

Footnotes 56 

1 
Footnotes 22 
Forcing a line break 40 
Forcing a page break 41 
FORMAT environment 16, 19, 33 
Funding acknovledgenent 31 

Greek characters, ho« to get 15 

SROUP 41 

CtiQOP parameter 40 



1 



Headings 19, 27 
like this one 
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Identifier 46 

IMMEDIATE parameter to gPage'heading 30 

IHBOOK bibliography entry type 48 

INDESTATIQi style paraaeter 57 

Indexing 23 

Insert, long form 15 

Insert, short for* 15 

Inserts 15, 16 

Inserts, long fforw 40 

Inter-line spacing 57 

Inter-paragraph spacing 56, 57 

ISSUE bibliography entry parameter 49 

Italics 12 

Italics, how to get 14 

ITEMIZE environment 17, 19 

JOUR DAL bibliography entry paraaeter 49 

Joy of Cooking 42 

Justification 56 

JUSTIFICATION style parameter 57 

LEPYMARSIS style parameter 57 
LETTB8 document type 25 

LETTERHEAD document type 25 

Line break, forcing v 40 

Line breaks 39, 40 

Line length 58 

Line printer output 7, 8, 14 

Line width 57 

MAJS0AL document type 25, 29, 62 
Manuscript File, definition of 3 

Manuscript fila # preparation of 6 
Manuscript file, processing of 7 

Manuscript files, processing of 4 
Margins, changing 57 
Mathematical formatting 35 
MISC bibliography entry type 48 
MSS file extension 6 

Nested delimiters 13 

Numbering pages 29 

Object references 42, 44 
Output characters 14 
Output devices 9 
Output files 7 
Overt* ar 15 
Overbar code 14 
Overstriklog 14 

PACE bibliography entry paraaeter 49 
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Page break, forcing 41 

Page breaks 40,, 41 

Page Headings 27, 29 

Page length 57 

Page number references 42 

Page numbering 44 

Page numbers 29 

PAPERLEiGTH style paraweter 57 

PAPERWIDTH style parameter 57, 58 

Paragraph indentation 56, 57 

POSTER doctwent type 25 

Printing devices 1, 8 

Quotation 15, 16 
QUOTATION environment 16 
•Quotations 5 

References 42 

REPORT bibliography entry type 48 

REPORT document type 25, 29, 62 

RBPOBT1 doc«B«at type 25 

ResearchCredit environment 31, 63 

Return marker 35 

RIGHTHARGW style parameter 57 

Roaan typeface, ho« to get 15 

Running heads 27 

Running SCRIBE 6 

SCHOOL bibliography entry paraneter 49 

Script code 14 

Section nu»ber references 42 

Section title 29 

sectioning a document 27 

Setting tab stops 34 

Setup cosnands 25 

Significant space 10, 39 

SLIDE docunent type 25 

Snail capitals, how to get 15 

SPACING style parameter 57 

Special characters 9, 66 

Spread 56 

SPREAD style parameter 57 

Strings, text 60 

Subheadings 27 

Subscripts, has to get 15 

Superscripts, ho« to get 15 

TAB character {Ctrl I) 35 

Tab stops 33, 34, 37 

Tabbing 35 
Table of Contents 28 
fables, how to make 50 
Tabs 20, 34, 36 
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TEXT dociHMnt type 24, 25 

TJj&'t reference 42 

text references 42 

Text strings SO 

THEOREM environment 17, 21 

Theorem nunber references 42 

Theorem mtabers 44 

THESIS bibliography entry type 48 

Tines Rosan font 54 

TITLE bibliography entry parameter 49 

Title page 27 •; 

Title page, example 62 ' 

Title page, how to produce 31 

Title&ox environment 31 

Titlepage environment 31, 62 

T0PMAR6IN style parameter 57 

Typeaheels for Diablo 55 

Typewriter font 15 

Underlining 14 
Underlining, hoa to get 14 

Yarlable-vidth fonts 33 

fi-RBATW environaent 16, 19, 33 

VERSE environ»ent 16, 17 

VOLUME bibliography entry parameter 49 

lord break 39 

lord breaks, forcing 39 

Mord breaks, preventing 39 

XGP 54, 67 

X€P output 8, 14 



